home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / readlink.man < prev    next >
Encoding:
Text File  |  1989-01-29  |  1.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. READLINK              C Library Procedures               READLINK
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      readlink - read value of a symbolic link
  10.  
  11. SSYYNNOOPPSSIISS
  12.      cccc == rreeaaddlliinnkk((ppaatthh,, bbuuff,, bbuuffssiizz))
  13.      iinntt cccc;;
  14.      cchhaarr **ppaatthh,, **bbuuff;;
  15.      iinntt bbuuffssiizz;;
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      _R_e_a_d_l_i_n_k places the contents of the symbolic link _n_a_m_e in
  19.      the buffer _b_u_f, which has size _b_u_f_s_i_z.  The contents of the
  20.      link are not null terminated when returned.
  21.  
  22. RREETTUURRNN VVAALLUUEE
  23.      The call returns the count of characters placed in the
  24.      buffer if it succeeds, or a -1 if an error occurs, placing
  25.      the error code in the global variable _e_r_r_n_o.
  26.  
  27. EERRRROORRSS
  28.      _R_e_a_d_l_i_n_k will fail and the file mode will be unchanged if:
  29.  
  30.      [ENOTDIR]      A component of the path prefix is not a
  31.                     directory.
  32.  
  33.      [EINVAL]       The pathname contains a character with the
  34.                     high-order bit set.
  35.  
  36.      [ENAMETOOLONG] A component of a pathname exceeded 255 char-
  37.                     acters, or an entire path name exceeded 1023
  38.                     characters.
  39.  
  40.      [ENOENT]       The named file does not exist.
  41.  
  42.      [EACCES]       Search permission is denied for a component
  43.                     of the path prefix.
  44.  
  45.      [ELOOP]        Too many symbolic links were encountered in
  46.                     translating the pathname.
  47.  
  48.      [EINVAL]       The named file is not a symbolic link.
  49.  
  50.      [EIO]          An I/O error occurred while reading from the
  51.                     file system.
  52.  
  53.      [EFAULT]       _B_u_f extends outside the process's allocated
  54.                     address space.
  55.  
  56. SSEEEE AALLSSOO
  57.      stat(2), lstat(2), symlink(2)
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0              August 26, 1985                        1
  64.  
  65.  
  66.  
  67.